This page last changed on Mar 10, 2009 by csut017.

It is possible to change the templates that are used in the dashboard. By default the dashboard looks in the /templates folder for the template to use. But, it is now possible to set a custom template location by setting <customtemplates> in <plugins>.

When a template is requested it will first look in the location specified by <customtemplates>. If there is a template in this folder it will use that template, otherwise it will use the template in the default location.

Templates

The following are some of the more commonly modified templates:

Template Description
SiteTemplate.vm The main site template.
This contains the header information (including links to the stylesheet and javascript), plus the overall layout for each page.
TopMenu.vm The breadcrumbs for each page.
FarmSideBar.vm The side bar for the farm-level views.
ServerSideBar.vm The side bar for server-level views.
ProjectSideBar.vm The side bar for project-level views.
BuildSideBar.vm The side bar for build-level views.
ProjectReport.vm The main project details page - this displays the build history graph.
ProjectGrid.vm The main grid display - this is the list of all the projects, their current status and the action buttons.

Note: The side bars contain all the actions from the plug-ins.

Themes

It is possible to build themes using the custom templates location. This normally involves adding a new SiteTemplate.vm and a new stylesheet. SiteTemplate.vm needs to be modified to point to the new stylesheet, plus any other theme changes.

Additionally, any of the other templates can be modified for a theme.

Document generated by Confluence on Mar 14, 2009 02:55